###Function###
FileRead

###Description###
Liest eine bestimmte Anzahl von Zeichen aus einer zuvor geffneten Datei.

###Syntax###
FileRead ( "filehandle/filename" [, count] )


###Parameters###
@@ParamTable@@
filehandle/filename
	Das Handle der Datei, wie es von einem frheren Aufruf von  <a href="FileOpen.htm">FileOpen()</a> zurckgegeben wurde. Alternativ kann ein String mit dem Dateinamen als erster Parameter verwendet werden.
count
	[optional] Die Anzahl der einzulesenden Zeichen - siehe Bemerkungen.
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	Die eingelesenen Zeichen. @extended wird auf die zurckgegebenen Bytes/Zeichen gesetzt.
Fehler:	Setzt @error.
@error:	1 = Die Datei wurde nicht im Lesemodus geffnet.
		-1 = Das Dateiende wurde erreicht
@@End@@


###Remarks###
Eine negative oder nicht definierte Anzahl der einzulesenen Zeichen liest die ganze Datei von der aktuellen Position ab.

Wenn ein Dateiname statt eines Dateihandles angegeben wird, wird die Datei whrend des Funktionsaufrufes geffnet und geschlossen. Fr die Bearbeitung groer Dateien ist das viel langsamer als die Arbeit mit Handles.
Hinweis: Nicht die Verwendung von Dateihandles und -namen vermischen. So soll man zum Beispiel nicht eine Datei mit <a href="FileOpen.htm">FileOpen()</a> ffnen und dann in dieser Funktion einen Dateinamen verwenden. Entweder Handles oder Dateinamen benutzen - nicht beides!

Sowohl ANSI als auch UTF16/UTF8 Formate knnen gelesen werden - AutoIt erkennt den Typ automatisch.

Eine Datei kann binr (byteweise) ausgelesen werden wenn <a href="FileOpen.htm">FileOpen()</a> mit dem Binrflag aufgerufen wird. In diesem Fall gibt count die Anzahl der Bytes an, nicht die der Zeichen.
Ein zu groer Wert fr Anzahl kann dazu fhren, dass AutoIt mit einem Speicherzugriffsfehler beendet wird.


###Related###
FileOpen, FileReadLine, FileWrite, FileWriteLine, String, FileSetPos, FileGetPos


###Example###
@@IncludeExample@@
